Payment Flow · Reference

Luồng thanh toán B2B — Thuốc Việt

Tham chiếu thiết kế cho dev: 3 bước (Giỏ hàng → Thanh toán → Kết quả) cho buyer B2B đã KYC. Trang Thanh toán phân nhánh theo 6 phương thức (Chuyển khoản · VietQR · ATM/Napas · Thẻ quốc tế · Ví điện tử · Công nợ). Khi chọn 1 phương thức, panel bên phải đổi nội dung dynamic.

01

Trang Giỏ hàng

Route: /cart · Step 1/5 · tích chọn SP · voucher per NCC
Note cho dev: Spec này thiết kế multi-NCC để chuẩn bị cho roadmap. V2 hiện tại chỉ enable 1 NCC / đơn (chỉ render group đầu tiên, ẩn 2 group còn lại). Khi mở multi-NCC ở V3 → bỏ flag singleNCC và render đủ. Hoá đơn VAT tách per NCC, voucher áp per NCC.
thuocviet.vn/cartstep 1/3Buyer scope FULL · 3 NCC · 5 SKU
hotro@thuocviet.vn Sàn dược B2B chuẩn pháp lý
Trang chủ Danh mục Hoạt chất Nhà bán hàng Hồ sơ pháp lý Hướng dẫn Tin tức
1Giỏ hàng
2Đặt hàng
3Thanh toán
4Chờ duyệt
5Hoàn Thành
An toàn giao dịch SSL · 3-D Secure
DHG Pharma — Cần Thơ
Hoá đơn riêng · giao 1–2 ngày
KYC NCC
Tất cả (2) Xoá đã chọn
Amoxicillin 500mg DHG
ETCHộp 10 vỉ × 10 viên·SĐK VD-23456-20
20
610.000₫
32.000₫30.500₫/Hộp
Paracetamol 500 Hapacol
OTCHộp 10 vỉ × 10 viên
50
600.000₫
12.000₫/Hộp
Mã NCC: DHGBULK50 Đơn ≥ 50 hộp giảm 50.000₫ −50.000₫
Tạm tính NCC 1.160.000₫
Imexpharm — Bến Lức
Hoá đơn riêng · giao 2–3 ngày
KYC NCC
Tất cả (1) Xoá đã chọn
Cefuroxime 500mg Imexpharm
ETCHộp 2 vỉ × 5 viên·SĐK VD-29871-21
15
1.275.000₫
85.000₫/Hộp
Tạm tính NCC 1.275.000₫
Pymepharco — Phú Yên
Hoá đơn riêng · giao 2–4 ngày
KYC NCC
Tất cả (1) Xoá đã chọn
Vitamin C 1000mg PMP
TPCNLọ 100 viên sủi
30
840.000₫
28.000₫/Lọ
Tạm tính NCC 840.000₫

Tóm tắt đơn hàng

Tạm tính (5 SKU · 3 NCC)3.325.000₫
Voucher NCC (DHGBULK50)−50.000₫
Phí vận chuyểnMiễn phí
VAT (đã gồm)~302.000₫
Tổng cộng 3.275.000₫
Multi-NCC checkout: đơn sẽ được tách thành 3 đơn con (1 đơn / NCC), mỗi đơn có hoá đơn VAT riêng. Vận chuyển độc lập.
Step indicator
Sticky dưới nav · 1/3 → 2/3 → 3/3
Bước done = xanh, active = đỏ, future = xám
Gộp theo NCC
Mỗi NCC = 1 card · hoá đơn VAT riêng
Voucher áp per NCC hoặc toàn đơn
Lock SKU theo scope
SKU ETC/KSĐB không hợp scope → badge "Bị khoá"
Buyer click → tooltip + CTA bổ sung giấy phép
Sticky summary
Sidebar 380px sticky · top: 16px
CTA chính ở dưới · luôn nhìn thấy tổng tiền
02

Trang Đặt hàng

Route: /order/place · Step 2/5 · SP đã chọn (không tích nữa) · voucher per NCC · tổng hợp đơn
thuocviet.vn/order/placestep 2/5Sau khi tích chọn từ Giỏ hàng → sang màn này xác nhận đơn
hotro@thuocviet.vn Sàn dược B2B chuẩn pháp lý
Trang chủ Danh mục Hoạt chất Nhà bán hàng Hồ sơ pháp lý Hướng dẫn Tin tức
Giỏ hàng
2Đặt hàng
3Thanh toán
4Chờ duyệt
5Hoàn Thành
5 SKU · 3 NCC · đã tích chọn từ Giỏ hàng
DHG Pharma — Cần Thơ
Hoá đơn riêng · giao 1–2 ngày
KYC NCC
Amoxicillin 500mg DHG
ETCHộp 10 vỉ × 10 viên·SĐK VD-23456-20
20
610.000₫
32.000₫30.500₫/Hộp
Paracetamol 500 Hapacol
OTCHộp 10 vỉ × 10 viên
50
600.000₫
12.000₫/Hộp
Mã NCC: DHGBULK50 Đơn ≥ 50 hộp giảm 50.000₫ −50.000₫
Xem voucher NCC →
Tạm tính NCC 1.160.000₫
Imexpharm — Bến Lức
Hoá đơn riêng · giao 2–3 ngày
KYC NCC
Cefuroxime 500mg Imexpharm
ETCHộp 2 vỉ × 5 viên·SĐK VD-29871-21
15
1.275.000₫
85.000₫/Hộp
Xem voucher NCC →
Tạm tính NCC 1.275.000₫
Pymepharco — Phú Yên
Hoá đơn riêng · giao 2–4 ngày
KYC NCC
Vitamin C 1000mg PMP
TPCNLọ 100 viên sủi
30
840.000₫
28.000₫/Lọ
Xem voucher NCC →
Tạm tính NCC 840.000₫

Tóm tắt đơn hàng

Tạm tính (5 SKU · 3 NCC)3.325.000₫
Voucher NCC (DHGBULK50)−50.000₫
Phí vận chuyểnMiễn phí
VAT (đã gồm)~302.000₫
Tổng cộng3.275.000₫
Multi-NCC checkout: đơn sẽ tách thành 3 đơn con (1 đơn / NCC), mỗi đơn có hoá đơn VAT riêng. Bước sau: chọn địa chỉ + thanh toán.
Khác với Giỏ hàng
Không có checkbox · SP đã chốt
Voucher input per NCC · link "Xem voucher NCC"
Voucher per NCC
Chip Mã NCC: ... nếu đã áp
Input + Áp dụng · gọn dưới mỗi NCC group
CTA Đặt hàng
Sang Step 3 Thanh toán
Quay lại giỏ hàng để thay đổi SP
Multi-NCC note
Banner xanh · nhắc dev
Đơn tách theo NCC · mỗi đơn có VAT riêng
03

Trang Thanh toán

Route: /checkout · Step 3/5 · Địa chỉ + ETC + 6 phương thức (V2 chỉ CK active)
thuocviet.vn/checkoutstep 2/3V2 · chỉ Chuyển khoản active · 5 phương thức khác disabled (làm mờ)
Bảo mật TLS 1.3 · PCI-DSS Level 1 Phiên thanh toán còn 14:32
SSL bảo mật Hoá đơn VAT điện tử Đổi/trả 7 ngày
Giỏ hàng
Đặt hàng
3Thanh toán
4Chờ duyệt
5Hoàn Thành
3.275.000₫ · 3 NCC · 5 SKU

Địa chỉ nhận hàng

Đổi địa chỉ
Nhà thuốc An Khang Q3 — DS. Trần Thị Hồng CHÍNH
123 Võ Văn Tần, P. Võ Thị Sáu, Q.3, TP. Hồ Chí Minh
SĐT: 0903 456 789 · Email: hong@ankhang.vn
Giờ nhận 8h–17h Có dấu pháp nhân

Chứng từ đơn hàng

2 SKU ETC · TT 26/2025 — lưu trữ 5 năm
Tải lên đơn đặt hàng có dấu
PDF/JPG · ≤10MB · 1 file cho cả đơn
Đơn ETC ≥ 1 SKU yêu cầu đơn đặt hàng có dấu pháp nhân. Hệ thống lưu lại 5 năm phục vụ kiểm tra của Sở Y tế.

Phương thức thanh toán

6 lựa chọn
Ghi chú V2: giai đoạn này chỉ hỗ trợ Chuyển khoản ngân hàng. Các phương thức khác (VietQR, ATM NAPAS, Thẻ quốc tế, Ví điện tử, Công nợ B2B) hiển thị để tham khảo, sẽ được kích hoạt ở phiên bản sau.

Thông tin chuyển khoản

Chuyển khoản đúng số tiền + nội dung bên dưới. Hệ thống tự động đối soát qua sao kê API ngân hàng — đơn xác nhận trong 2–5 phút giờ hành chính.

Ngân hàng nhận
Vietcombank — CN TP.HCM
Số tài khoản
0011 0023 4567
Tên tài khoản
CT CP THUOC VIET PHARMA
Số tiền
3.275.000 ₫
Nội dung CK
TV-26052017 ANKHANG
Tự động đối soát: không cần upload chứng từ. Sai nội dung CK → cần CSKH ghép thủ công (chậm 1–2 giờ hành chính).

Đơn hàng (5)

Amoxicillin 500mg DHG ×20
DHG Pharma
610.000₫
Paracetamol 500 Hapacol ×50
DHG Pharma
600.000₫
Cefuroxime 500 ×15
Imexpharm
1.275.000₫
Vitamin C 1000 ×30
Pymepharco
840.000₫
Tạm tính3.325.000₫
Voucher−50.000₫
Vận chuyểnMiễn phí
Phí thanh toán0₫
Cần thanh toán3.275.000₫
Tiếp tục đồng nghĩa bạn đồng ý với Điều khoản dịch vụ và Chính sách hoàn trả
03b

Reference · Panel dynamic theo từng phương thức

6 variants chi tiết · dev tham chiếu khi bật lại phương thức ở V3+ · sub-states của Step 3
01

Chuyển khoản ngân hàng

Khuyến nghị · Phí 0₫

Thông tin tài khoản nhận

Ngân hàng
Vietcombank — CN TP.HCM
Chủ TK
CT CP THUOC VIET PHARMA
Số TK
0011 0023 4567
Số tiền
3.275.000 ₫
Nội dung CK
TV-26052017 ANKHANG
Tự động đối soát sao kê qua API ngân hàng — không cần upload chứng từ. Đơn xác nhận trong 2–5 phút giờ hành chính, ~30 phút ngoài giờ.

Hướng dẫn

  1. Mở app ngân hàng / Internet Banking
  2. Chuyển khoản đúng số tiền + nội dung ở bảng trái
  3. Hệ thống tự động khớp sao kê 2–5'
  4. Trạng thái đơn cập nhật sang Đã thanh toán
Bắt buộc nội dung CK đúng: sai cú pháp → đối soát thất bại, cần liên hệ CSKH gắn thủ công (chậm 1–2h).
02

VietQR · NAPAS 247

Phổ biến · <5s
napas
247
Hết hạn sau 04:58
Vietcombank ·BIDV·Techcombank·MB·+40 NH

Quy trình tức thì

1
Mở app ngân hàng → Quét QR
Số tiền + nội dung đã pre-fill, không cần nhập thủ công
2
Xác nhận trong app
Sinh trắc học hoặc Smart OTP
3
Webhook NAPAS đẩy về < 5s
Trang tự refresh sang Kết quả · gửi mail xác nhận
03

Thẻ ATM nội địa · NAPAS

40+ NH · OTP SMS

Thông tin thẻ

Xác thực OTP

Mã OTP gửi tới 0903 ••• 789
Hết hạn sau 02:14 · Gửi lại
Hệ thống không lưu CVV. Toàn bộ giao dịch chạy qua cổng NAPAS — đạt chứng nhận PCI-DSS Level 1.
04

Thẻ tín dụng / Ghi nợ quốc tế

Visa · Mastercard · JCB · Phí 2.5%

Thông tin thẻ

VISA

Chi tiết phí

Giá trị đơn
3.275.000 ₫
Phí thẻ (2.5%)
81.875 ₫
Tổng thanh toán
3.356.875 ₫
Đơn vị thu
Stripe Asia · Visa / Mastercard
3-D Secure: sau khi nhấn "Đặt & thanh toán", bạn sẽ được redirect tới trang xác thực ngân hàng phát hành (~30s) trước khi quay lại Thuốc Việt.
05

Ví điện tử

MoMo · ZaloPay · VNPAY · ShopeePay

Chọn ví

Redirect & callback

MoMo
Chuyển khoản
3.275.000₫
Bước 1: Redirect tới app MoMo (deeplink trên mobile, QR trên desktop)
Bước 2: Xác nhận trong app · OTP / sinh trắc học
Bước 3: Callback về Thuốc Việt · 1–3s
Không lưu thông tin ví trên Thuốc Việt. Mỗi giao dịch sinh token một lần qua MoMo Gateway.
06

Công nợ B2B · NET 30 / NET 60

Trả sau · Đủ điều kiện · Phí 0₫

Hạn mức công nợ

Đã dùngHạn mức tổng
22.500.000₫50.000.000₫
Còn lại27.500.000₫

Tóm tắt sau giao dịch

Đơn này
3.275.000 ₫
Hạn mức sau giao dịch
25.775.000 ₫ / 50M
Còn lại
24.225.000 ₫
Phải trả trước
25/06/2026
Lãi suất quá hạn
1.2% / tháng
Quá hạn 7 ngày → khoá đặt mới + báo cáo CIC. Quá hạn 30 ngày → đưa qua thu hồi nợ.
04

Trang Chờ duyệt

Route: /order/{orderId}/review · Step 4/5 · Đặt hàng thành công · chờ NCC xác nhận ≤ 24h
thuocviet.vn/order/TV-26052017/reviewstep 4/5Trạng thái Chờ NCC xác nhận · ≤ 24h
Chờ NCC xác nhận ≤ 24h
Giỏ hàng
Đặt hàng
Thanh toán
4Chờ duyệt
5Hoàn Thành

Đặt hàng thành công — chờ NCC xác nhận

Tồn kho đã được giữ chỗ. NCC có 24h để xác nhận hoặc từ chối (TT-04). Bạn có thể đóng tab — sẽ được email khi NCC duyệt.

Mã đơn
TV-26052017
Trạng thái
PENDING · Chờ NCC
Số NCC
3 đơn con
1
Chờ NCC
Hiện tại
2
Đã xác nhận
Trong 24h
3
Đang giao
1–2 ngày
4
Hoàn tất
—
05

Trang Hoàn Thành

Route: /order/{orderId}/done · Step 5/5 · NCC đã xác nhận · email + VAT điện tử đã gửi
thuocviet.vn/order/TV-26052017/donestep 5/5Trạng thái Hoàn tất · 3 đơn con đã được xác nhận
Đơn hoàn tất
Giỏ hàng
Đặt hàng
Thanh toán
Chờ duyệt
Hoàn Thành

Đặt hàng thành công

Đơn hàng #TV-26052017 đã được xác nhận. Email xác nhận và hoá đơn VAT điện tử (3 NCC) gửi tới hong@ankhang.vn.

Mã đơn
TV-26052017
Đã thanh toán
3.275.000 ₫
Phương thức
VietQR · VCB
Số NCC
3 đơn con
Dự kiến giao
26 → 30/05
Hoá đơn VAT
Đang sinh
3 đơn con
TV-26052017-DHG · DHG Pharma · 2 SKU1.160.000₫
TV-26052017-IMP · Imexpharm · 1 SKU1.275.000₫
TV-26052017-PMP · Pymepharco · 1 SKU840.000₫
04b

Variants · NCC từ chối đơn (Step 4 sub-states)

Trong 24h chờ duyệt, NCC có thể huỷ vì hết hàng, quá thời hạn xác nhận, hoặc chứng từ KSĐB không hợp lệ — buyer nhận thông báo + hoàn tiền tự động
thuocviet.vn/order/TV-26052017/reviewstep 4/5 · cancelledNCC huỷ · Hết hàng · Pymepharco
NCC từ chối · Hết hàng
Giỏ hàng
Đặt hàng
Thanh toán
NCC huỷ đơn
5Hoàn Thành

1 đơn con bị huỷ — hết hàng tạm thời

NCC Pymepharco đã huỷ đơn con TV-26052017-PMP vì hết hàng Vitamin C 1000mg PMP. 2 đơn con còn lại (DHG, Imexpharm) vẫn được xử lý bình thường.

Đơn bị huỷ
TV-26052017-PMP
Lý do
Hết hàng (NCC)
Hoàn tiền
840.000 ₫ · auto
Hoàn tiền tự động trong 1–3 ngày làm việc
Khoản 840.000₫ sẽ hoàn về tài khoản Vietcombank gốc. Bạn có thể: (1) tìm SP thay thế từ NCC khác trên catalog, (2) nhận thông báo khi NCC có hàng lại, (3) liên hệ CSKH 1800 0000.
thuocviet.vn/order/TV-26052017/reviewstep 4/5 · timeoutAuto-cancel · NCC quá hạn 24h
NCC quá hạn xác nhận
Giỏ hàng
Đặt hàng
Thanh toán
Quá hạn
5Hoàn Thành

Đơn tự huỷ — NCC không xác nhận trong 24h

Quá 24 giờ kể từ lúc đặt, NCC Imexpharm không xác nhận đơn con TV-26052017-IMP. Hệ thống tự huỷ theo SLA TT-04 · trừ điểm NCC + hoàn tiền cho buyer.

Đơn bị huỷ
TV-26052017-IMP
Quá hạn
24h 12'
Hoàn tiền
1.275.000 ₫ · auto
Đã ghi nhận trừ điểm NCC
NCC Imexpharm bị trừ −5 điểm SLA. Sau 3 vi phạm/tháng → hệ thống ưu tiên NCC khác. Hoàn tiền về thẻ Vietcombank gốc trong 1–3 ngày làm việc.
thuocviet.vn/order/TV-26052017/reviewstep 4/5 · doc-rejectedNCC từ chối · Chứng từ KSĐB không hợp lệ
Chứng từ KSĐB cần bổ sung
Giỏ hàng
Đặt hàng
Thanh toán
Cần bổ sung
5Hoàn Thành

NCC từ chối — Chứng từ KSĐB không hợp lệ

NCC DHG Pharma từ chối đơn con vì Đơn đặt hàng có dấu (Order-AnKhang-1304.pdf) không khớp với CCHN dược sĩ phụ trách. Vui lòng bổ sung chứng từ đúng trong 48h, hoặc đơn sẽ tự huỷ + hoàn tiền.

Đơn bị giữ
TV-26052017-DHG
Hạn bổ sung
48h · còn 39h 22'
Cần bổ sung
CCHN + Đơn dấu mới
Yêu cầu của NCC
· Đơn đặt hàng có dấu pháp nhân (mới, đúng MST + tên cơ sở)
· CCHN dược sĩ phụ trách chuyên môn còn hiệu lực
· NĐ 54/2017 §43-44 + TT 20/2017
Out-of-stock
NCC chủ động huỷ · auto-refund trong 1–3 ngày
CTA: Tìm SP thay thế hoặc Báo có hàng
Timeout 24h
Hệ thống tự huỷ · trừ −5 điểm SLA NCC
SLA TT-04 · ưu tiên NCC khác lần sau
Doc rejected (KSĐB)
Buyer có 48h bổ sung chứng từ
NĐ 54/2017 · TT 20/2017
Multi-NCC isolation
1 NCC huỷ không kéo theo NCC khác
Mỗi đơn con xử lý độc lập · VAT riêng
05b

Variants · Step 3 sub-states

"Chờ đối soát CK" (Chuyển khoản) + "Thất bại" (Thẻ bị từ chối) — không phải step riêng, mà là sub-state của Thanh toán
thuocviet.vn/checkout/result/TV-26052018step 3/3Trạng thái Đang xử lý · Bank transfer · chờ sao kê đối soát
Đang đợi thanh toán
Giỏ hàng
Đặt hàng
Thanh toán
Chờ duyệt
5Hoàn Thành

Đang chờ xác nhận thanh toán

Bạn đã chọn Chuyển khoản ngân hàng. Khi sao kê về (~2–5 phút giờ hành chính), đơn sẽ tự cập nhật. Bạn có thể đóng tab — chúng tôi sẽ email khi xong.

Mã đơn
TV-26052018
Cần thanh toán
3.275.000 ₫
Phương thức
CK Vietcombank
Đã ghi nhận chưa thanh toán
Chúng tôi đang chờ giao dịch 3.275.000₫ với nội dung TV-26052018 ANKHANG vào TK 0011 0023 4567 · Vietcombank. Mã đơn sẽ tự huỷ sau 24h nếu không thấy giao dịch.
thuocviet.vn/checkout/result/TV-26052019step 3/3Trạng thái Thất bại · Thẻ bị từ chối
Cần xử lý
Giỏ hàng
Đặt hàng
Thanh toán thất bại
4Chờ duyệt
5Hoàn Thành

Thanh toán không thành công

Giao dịch thẻ •••• 1111 bị ngân hàng phát hành từ chối. Đơn hàng #TV-26052019 vẫn được giữ trong 30 phút — bạn có thể thử phương thức khác.

Mã lỗi DECLINED-51 · Insufficient funds
Ngân hàng phát hành báo không đủ số dư. Bạn có thể: (1) thử thẻ khác, (2) chuyển sang VietQR / chuyển khoản (phổ biến hơn), (3) dùng Công nợ B2B nếu hạn mức cho phép.